home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format CD 37 / Amiga Format CD37 (1999-02-16)(Future Publishing)(GB)(Track 1 of 3)[!][issue 1999-03].iso / +system+ / tools / graphics / fastview / readmefirst! < prev    next >
Text File  |  1998-09-07  |  8KB  |  256 lines
  1. This is a BETA release of FV (formerly known as FastView).
  2.  
  3. Since AmiNet may face legal problems if I uploaded this
  4. program under the name FastView which now suddenly has been
  5. copyrighted by someone else, I've been forced to change the
  6. name of the program.  It will now simply be known as FV, but
  7. we all know what that stands for.
  8.  
  9. I've started from scratch with this version of FV, and it
  10. contains almost nothing from the old FastView 2.0 version
  11. which could be found on AmiNet just a few months ago (before
  12. it was removed for legal reasons).
  13.  
  14. ------------------------------------------------------------
  15.  
  16. This a very early BETA which at the moment just barely suits
  17. my own needs.  To avoid disappointment I will first tell you
  18. what this version of FV won't do (yet):
  19.  
  20.  - It won't work with OCS/ECS/AGA
  21.  
  22.  - It won't display IFF, BMP or PCX pictures
  23.  
  24.  - It doesn't have a filerequester and there is no
  25.    workbench support
  26.  
  27. I should also warn you that this version has not been tested
  28. on any other configs than my own (4000/060 with Kick 3.1 and
  29. CyberGraphX), but this version of FV has run fine on my
  30. machine for months now.
  31.  
  32. So what does it currently do?
  33.  
  34.  - Supports CyberGraphX, so it can display pictures in
  35.    hicolor and truecolor
  36.  
  37.  - Displays JPEG pictures using the JPEG Codec by Christoph
  38.    Feck (get it from Aminet)
  39.  
  40.  - Supports most types of GIF pictures, including
  41.    progressive decoding of Interlaced GIFs
  42.  
  43.  - Pictures are converted to 256 colors or grayscales if
  44.    necessary
  45.  
  46.  - Autoscaling; if pictures are too big to open a screen
  47.    for then FV will try to scale down the pictures until a
  48.    screen can be opened
  49.  
  50.  - AmigaDOS patterns (wildcards) supported
  51.  
  52.  - Pictures are loaded and decoded in the background to
  53.    speed up viewing multiple pictures; this can take quite
  54.    some memory especially with 24-bit pictures
  55.  
  56.  - Pictures can be displayed in alphabetic and random order
  57.  
  58.  - Customised information about the picture can be displayed
  59.    above the picture
  60.  
  61.  - The function keys can be defined to perform actions on
  62.    the picture while viewing it
  63.  
  64.  - A script file let's you customise what screenmodes FV
  65.    is allowed to choose from
  66.  
  67. ------------------------------------------------------------
  68.  
  69. Command line arguments
  70.  
  71. (Following are the command line arguments which already work
  72. in this version):
  73.  
  74. FILES/M
  75.  
  76. Allows you to specify one or more files or patterns.
  77.  
  78.  
  79. ALL/S
  80.  
  81. Specify this if you want FV to scan directories recursively.
  82.  
  83.  
  84. ORDER/K
  85.  
  86. This allows you to change the order in which the pictures
  87. are displayed.
  88.  
  89.  "A" : sorts the files alphabetically by their filename
  90.  "P" : sorts the files alphabetically by their full pathname
  91.  "R" : random
  92.  
  93. The default is to display the pictures in the order they
  94. were entered on the commandline or, in the case of
  95. wildcards, in the order they were found in the directory.
  96. If you specify a string not beginning with one of the
  97. letters described above then this keyword will default to
  98. using the random order.
  99.  
  100. Note: Only the first letter is checked for this keyword, so
  101.       it is possible to specify things like
  102.       "ORDER=alphabetical" or "ORDER=random" to get the
  103.       desired results.
  104.  
  105.  
  106. INFO/K
  107.  
  108. This option displays information above the picture.  It
  109. allows you to specify a formatting string to customize the
  110. information.  If you specify 'INFO=""' then the default
  111. formatting string is used (see below).
  112.  
  113. To customize the information string you simply specify a
  114. string after the keyword.  The string can contain these
  115. special character sequences which will be automagically
  116. replaced:
  117.  
  118.  %N = the complete path plus the name of the picture
  119.  
  120.  %n = the name of the picture (without path)
  121.  
  122.  %x = the horizontal size of the picture in pixels (not
  123.       taking scaling into account)
  124.  
  125.  %y = the vertical size of the picture in pixels (not
  126.       taking scaling into account)
  127.  
  128.  %d = the depth of the picture on disk (not the depth
  129.       of the screen!)
  130.  
  131.  %% = gives you a single '%'-character
  132.  
  133. The default string looks like this: "%n (%xx%yx%d)" which
  134. for example could result into:
  135.  
  136.  Test.jpg (640x480x24)
  137.  
  138. for a color JPEG picture named 'Test.jpg' of 640x480 pixels.
  139.  
  140.  
  141. F1/K, F2/K, F3/K, F4/K, F5/K, F6/K, F7/K, F8/K, F9/K, F10/K
  142.  
  143. These options allow you to define a custom function for each
  144. of the function keys.  The specified function will be
  145. executed each time you press the corresponding function key.
  146. FV will advance to the next picture when the function has
  147. completed.
  148.  
  149. Examples (also see the INFO/K option for a description of
  150. the special '%' character sequences):
  151.  
  152.   F1="Copy %N PICS:Sorted/Cars/Lamborghini/"
  153.  
  154.   Pressing F1 will copy the picture to
  155.   PICS:Sorted/Cars/Lamborghini - %N is automatically
  156.   replaced by the full pathname of the picture.  Be warned
  157.   however that the C/Copy command simply replaces any
  158.   picture of the same name in the destination directory.
  159.  
  160.   F5="Rename %N :Trashcan/%n"
  161.  
  162.   F5 will 'move' the picture into the trashcan directory
  163.   on the same drive.  Note that %n is replaced by just the
  164.   name of the picture, without its path.  Note that unlike
  165.   C/Copy, C/Rename will fail when there is already a
  166.   picture of the same name in the destination directory.
  167.  
  168.   F10="Delete %N"
  169.  
  170.   F10 now simulates the behaviour of the Shift + Del
  171.   function of FV.
  172.  
  173.  
  174. LEAVEMEM/K/N
  175.  
  176. Specifies the amount of memory in kilobytes FV should
  177. leave free.  You can use this keyword to limit FV's
  178. use of memory for predecoding pictures.  It defaults
  179. to 2048 kB.
  180.  
  181.  
  182. DEBUG/S
  183.  
  184. Use this when sending bugreports.  It will output some
  185. additional information which makes it easier for me to
  186. analyze the problem.
  187.  
  188.  
  189. All the other keywords don't work yet, and some of them
  190. may never work (and will be removed at a later date).
  191.  
  192. ------------------------------------------------------------
  193.  
  194. The fvmodes file
  195.  
  196. In this file you can specify what screenmodes FV should be
  197. allowed to choose from.  Every line not starting with a
  198. comment introducer ("*", ";") will be interpreted by FV.
  199. You're not allowed to put blank lines in this file (not yet
  200. anyway).  The last line of the file must read "#END".  Below
  201. is an example:
  202.  
  203. * Put your comments here!
  204.  NOMW=800 NOMH=600 DEPTH=8  DESCRIPTION="800x600 in 8 bit"
  205.  NOMW=800 NOMH=600 DEPTH=16 DESCRIPTION="800x600 in 16 bit"
  206. #END
  207.  
  208. Any line not starting with a comment introducer is
  209. interpreted using the following template:
  210.  
  211.  "NOMW/N,NOMH/N,DEPTH/N,DESCRIPTION"
  212.  
  213. NOMW/N and NOMH/N
  214.  
  215. These are used to specify the normal width and height of the
  216. screenmode you want to select.  This is the visible size of
  217. the screenmode (see the ScreenMode prefs program which came
  218. with Workbench).
  219.  
  220.  
  221. DEPTH/N
  222.  
  223. This is the number of bits per pixel or the number of
  224. bitplanes of the screenmode you want to select.
  225.  
  226.  
  227. DESCRIPTION
  228.  
  229. An optional description which isn't used at the moment.
  230.  
  231.  
  232. FV will interpret this list of screenmodes at the start of
  233. the program and warn you of any errors.  If FV couldn't find
  234. a suitable modeid for the screenmode you described it will
  235. warn you about this and output the line number were the
  236. problem is located.
  237.  
  238. ------------------------------------------------------------
  239.  
  240. That's about it for the moment for the 'documentation'.
  241.  
  242. If there are any problems feel free to contact me.
  243.  
  244. Don't forget to include a debug output (using the DEBUG
  245. switch) and some information about your Amiga (use
  246. ShowConfig for example).  If you want to mail me a (large)
  247. picture which helps identifying a problem then please use
  248. the john@globalxs.nl account.
  249.  
  250.         EMail    : john@globalxs.nl
  251.                    john.hendrikx@grafix.xs4all.nl
  252.  
  253.         Fido     : 2:286/407.8
  254.         AmigaNet : 39:153/201.8
  255.         NLA Net  : 14:101/200.8
  256.